.. _cmsHomeSetConfig:

cmsHomeSetConfig
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

    VT_I4 cmsHomeSetConfig([in] VT_I4 BoardID, [in] VT_I4 Axis, 
    [in] VT_I4 ParamId, [in] VT_I4 ParamVal)           

DESCRIPTION
`````````````  

- cmsHomeSetConfig() 함수는 원점복귀에 관련된 여러가지 환경을 설정합니다.   

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의
  첨두어 cms 가 붙지 않습니다.


PARAMETER
`````````````

▶ BoardId: 사용자가 설정한 디바이스(보드) ID. 
 
▶ Axis : 축(채널) 번호. 축번호는 상수값으로  0번째 채널을 기준 채널로 임의의 채널을 
설정할 수 있습니다. 
 
▶ ParamId : 설정하고자 하는 파라미터 ID 값을 지정합니다.해당 ID값의 의미는 다음과 
같습니다. 

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

    Value, Meaning
    "| 0 또는 cmsHPID_HOME_MODE", "
     |                              원점복귀를 수행 할 때 사용할 복귀 방법을 지정합니다.
     |                              "
    "| 1 또는 cmsHPID_HOME_DIR", "
     |                             원점복귀를 수행 할 방향을 지정합니다. 
     |                             "           
    "| 3 또는 CmHPID_HOME_EZ_COUNT", "
     |                              원점복귀를 수행 할 때 사용할 EZ Count 를 설정합니다. 
     |                              "     

▶ ParamVal : cmsHomeSetConfig함수의 인자이며, 파라미터 ID값에 따른 실제 지정하고자 
하는 파라미터의 적용 값을 의미합니다. 각값의 적용범위는 파라미터ID 별로 다르며 해당 
값의 의미는 다음 표와 같습니다.      
      
- ParamID 가 0 인 경우

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

    Value, Meaning
    "| 0 또는 cmsHOME_MODE_ORG_ONCE", "
     |                              원점센서를 1회 사용한 원점복귀를 시행합니다.
     |                              "
    "| 1 또는 cmsHOME_MODE_ORG ", "
     |                             원점센서를 사용한 원점복귀를 시행합니다.
     |                             "           
    "| 3 또는 cmsHOME_MODE_EL", "
     |                              EL 센서를 사용한 원점복귀를 시행합니다. 
     |                              "    
    "| 4 또는 CmsHOME_MODE_EZ_COUNT ", "
     |                              EZ Count 를 사용한 원점 복귀를 시행합니다. 
     |                              "    
     
- ParamID 가 1 인 경우

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

    Value, Meaning
    "| 0 또는 cmsDIR_N ", "
     |                      음의 방향으로 원점복귀를 시행합니다."
    "| 1 또는 cmsDIR_P  ", "
     |                      양의 방향으로 원점복귀를 시행합니다."

- ParamID 가 3 인 경우

  .. csv-table::
   :widths: 100
   :header-rows: 1
   :stub-columns: 0

    Meaning
   "| 원점 복귀 방법 중 EZ 카운트를 사용하는 복귀 방법을 진행 할 경우에 
    | 사용할 EZ Count 값을 의미합니다."

▶ ParamVal : cmsHomeGetConfig 함수의 인자이며, 파라미터 ID값에 따른 실제 지정된 
파라미터의 적용 값을 반환합니다. 


RETURN VALUE
`````````````

+------------+-----------+
|    Value   | Meaning   |
+============+===========+
|    음수    | 수행 실패 |
+------------+-----------+
| ERR_NONE   | 수행 성공 |
+------------+-----------+